home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 April / macformat-023.iso / Shareware City / Graphics / FloatingFractals3.1∂.PPC folder / Adam's Quirky ReadMe 3.1 PPC next >
Encoding:
Text File  |  1994-11-17  |  8.5 KB  |  132 lines  |  [ttro/ttxt]

  1. Floating Fractals 3.1∂
  2. ReadMe (A SimpleText Document)
  3. "Teachtext" will not display this document with the proper fonts and colors.
  4. If the title "Floating Fractals 3.1d" is not big and blue... your textreader sucks!
  5.  
  6. Thank you for downloading this fractal learning tool.
  7.  
  8. Adam Smith is reachable (but not tangible) at: smithab@mailbox.syr.edu
  9. for bug reports, suggestions, comments, whatever....
  10.  
  11. If you use my program, send me e-mail!!!!!! Especially if you use this as a fractal teaching tool.  Yes, you are obligated.
  12.  
  13. Why this version is special:
  14.  This release of Floating Fractals for Power Macintosh uses a new graphics routine to achieve 3.5 times the graphics speed of version 3.0ß.
  15.  
  16. Running Floating Fractals:
  17.  
  18.  
  19. Assuming you have downloaded the correct version for your machine (PPC, 68040 or 68K SANE if you have no FPU), you should be able to simply double click to launch.  Details on actual operation of the program are given below in the “Using Floating Fractals” section, and memory problems are addressed in Technical Notes: Bugs, also below.
  20. Do not use this product with any "non-prescription" drugs.
  21.  
  22. Files that comprise Floating Fractals:
  23.  
  24.     ReadMe "Floating Fractals" (You are reading this now)
  25.     Floating Fractals 3.1d for Power Macintosh
  26.  
  27. Required Hardware Configuration:
  28.  
  29. Power Macintosh 8100, 7100 or 6100 w/cache. (of course)
  30. 832 by 624 monitor with Thousands of colors recommended.
  31.  
  32. This application is for use on Power Macintoshes.  I created a 68040 version to benchmark against the Power Macs.  Power Macintosh 8100 users running version 3.1 will see approximately 25-30 times the performance of the 68040 version on an 840AV :-)
  33.  
  34. Best calculation times for the default view (100 iterations on a 640 by 480 monitor):
  35.  
  36.                 Power Macintosh 7100/66                                            1.95 seconds
  37.                 Centris 650                                                                                            50 seconds
  38.  
  39. Using Floating Fractals:
  40.  
  41. Floating Fractals likes to avoid system crashes by intelligently enabling and disabling menu options.  Initially, the options are stupid:    
  42.     
  43.   About Floating…             Pops open my cool about/info boxes
  44.     Close                                             Closes the main graphics window
  45.     Quit                                                        Quits, surprised?
  46.     Fractal Type                             Choose a complex function mapping
  47.     Iterations                                  Select the maximum number of Iterations
  48.   Iteration Multiplier     Selects a constant by which the number of iterations is multiplied
  49.     Set Glo Color™…              Picks the root color of the Glo Color Table
  50.     Use Glo Colors™                 Pre-selected. De-selecting enables HSV 'hue cycle' palattes.
  51.     Hide Info Window          Hides the Window with info about the calculations.
  52.                     
  53. Submenu choices which are checked are the defaults.  These should be:
  54.          
  55.                 Mandelbrot Set for the type
  56.                 1000 for the Maximum iteration number
  57.                 1.0 for the Iteration Multiplier
  58.                 Glo Colors™ (no, I did not trademark it, it just looks cooler that way)
  59.  
  60. The Main Viewing Sector (opened upon launch) will scale to your screen with a maximum size of 640 by 480 on monitors supporting 832 by 624 or larger displays.
  61.  
  62. You may have to pump up the  iteration multiplier if you zoom way in.  If out-of-set areas are not solid-colored, for example, or if the set is black and blotchy.  A setting of 2500 for Maximum iterations should be enough for most of life's problems.
  63.  
  64. The Fractals:
  65.  
  66. The Mandelbrot Set:  The famous one of the bunch. Hooray :-|
  67. The Drawn and Quartered Mandelbrot:  The Mandelbrot Set, with a hyperbolic-type singularity at the origin (division by zero!).
  68. The True Delta Set:    A manipulation of the Mandelbrot function.  Contains miniature likenesses of itself and of the Mandelbrot Set (Look Hard!) See the sample PICTs for an example of this.
  69. Others:  Manifestations of my 3rd Stage Mind.  These contain interesting spiral and fluid-like space-time discontinuous tensor manifold fields. (Whatever!)
  70.  
  71.                                                                                 Now, Fractalize! and enjoy.
  72.  
  73. New This Release (from version 2.0):
  74.  
  75. •All SetCPixel routines have been replaced with direct RAM writes for 3.5 times the graphics performance!
  76. •You can now save PICT files!
  77. •New About Box PICTs.
  78. •New Info Window
  79. •Now shows a cross cursor while selecting zoom areas
  80. •New Fractals!
  81. •New adjustable hue HSV palatte, plus the Glo Colors™ palatte!!!.
  82. •Eats more RAM! (for a save buffer) Now a whopping 1.0Mb RAM chewer!
  83. •Notice: New defaults for Iterations (1000)…
  84. •New Formula to calculate Necessary Iterations
  85. •New option "Iteration Multiplier" for manually forcing 2, 5 or 10 times more iterations
  86. •No longer zooms into areas smaller than 4 pixels.  This prevents zooming-into-a-single-pixel type accidents.
  87. •Undo backs out of the last Zoom-In
  88. •No longer erases your hard disk ;-)
  89.  
  90. Technical Notes:
  91.  
  92. The name "Floating Fractals" refers to two only things, and could thus be considered a condensed form of "Floating-Point Numeric Fractal Generator".
  93. Code was generated with Metrowerks’ CodeWarrior C for PPC.
  94. I used my trusty 7100 16/250 to test the 601 code, and on occasion,
  95. our school's Q650's and a Q800 to test the '040 code.  I also compiled the SANE version for 68K so that I could test the 68K application on my 882-less PowerMac in emulation-mode.
  96. Other than what I have checked, there has been very little testing of this program.  Bugs are likely, especially on computer configurations that are non-standard or not available for me to test this program on.  This software has not been officially checked out on any 030 or 020 machines.
  97.  
  98. Specifications:
  99.  
  100. Floating Fractals is from my original C source.  It uses a true RGB palatte, selected according to escape time (not by true point potential, however), and calculated from an HSV hue or value ramp.  All GWorlds are 16-bit.  All calulations are done with 64-bit doubles on the Powermacs.  80-bit 882 code on the rest.  The other sample Fractal Sets provided, I made up. Most are not really near-self-similar like the Mandelbrot set, but they have some neat fluid patterns within.
  101.  
  102. Floating Fractals has a formula that determines how many iterations are to be done, based on the real number range of the viewing area.  The number of iterations is proportional to the
  103. log of the real number range.  I provided a simple scalar control over this function, Iteration Multiplier.  This allows you to multiply the number of iterations in cases where you do not feel that the picture is accurate enough.
  104.  
  105. Shortcomings:
  106.  
  107. 1.    The calculation routine locks up the interface and only offers the standard Command-period abort.  I most likely will not fix this any time soon.  On PowerMacs, calculation time is short enough that no one would want to background it (about 7 seconds for the default image on an 832 by 624 monitor).
  108.  
  109. 2.    The Algorithm for finding all-black areas is a hack.  For speed on the 68K machines, I don’t do a thorough check of block border pixels.  For this reason, You will see solid black block artifacts if you have the iterations number set too low or if you are cursed.  Too bad.
  110.  
  111. 3.  Creates PICT files with it's own application signature, but cannot re-open them.
  112.  
  113. 4.  Still has no practical, real-world applications.
  114.  
  115. 5.  Still doesn't cure cancer either, sorry.
  116.  
  117.  
  118. Possible Bugs/Acknowledged Problems:
  119.  
  120. 1.    Problem?:  A large full-screen buffer is allocated on the System’s Heap (for Quickdraw). This may cause crashes (not on my computers) if you simply don’t have enough memory, although it will attempt to just warn you “Not Enough Available RAM!” (most likely scenario)
  121.  
  122. 2.     Problem!:  I hacked this App between my engineering classes.  Hey it was free, OK?
  123.  
  124. 3.     Problems:  I still use too many exclamation points in my documentation!!! I dont yous spelcheking eathir.
  125.  
  126. Thanks to: (finally!):
  127.  
  128. “The New Galactic Emperor” here at syr.edu for suggesting function pointers to multiple fractals!, and for his numerous tips that kept me away from my debugger.  Thanks to Tony Yang at Tufts for his on-line help in the aesthetics dept. and the time he spent testing this out. Thanks to everyone else who tried out my program but may not wish to be mentioned by name.
  129.  
  130. The Fine Print (Read Carefully!)
  131.  
  132. Floating Fractals 3.1 by Adam Smith, Nov, 1994. You take the risks, should any exist.  I am not a computer scientist (yeah!); I am a janitor at Syracuse University, Techno-MIDI junky and former //e programmer who just thinks Macs and Fractals are cool beans!)  This software is freeware, but I retain all my rights to it.  You may not use this software for any commercial purposes without consent from its author (me).  As this is a learning tool, distribution without the accompanying documentation is strongly discouraged, as is distribution of only one machine's version of the software. No, I am not really a janitor!  Quickdraw, Macintosh and Power Macintosh are registered trademarks of Apple Computer, Inc.